Function: data(object, key, value)

Description: Sets or retreives data bound to an object.

Returns: domElement or $A object if chained when setting a value, or the stored value if omitted.

Note: As with the value, the key may be set using any type of object, including strings, DOM nodes, and object instances.

Example:

// Set a data value on an object
$A.data(domElement, "pointsTo", domElement2);

// Get a data value from an object
var myElement2 = $A.data(domElement, "pointsTo");

// Or the same using chaining

// Set a data value on an object
var myChain = $A(domElement).data("pointsTo", domElement2); // myChain when returned = domElement

// Get a data value from an object
var myChain = $A(domElement).data("pointsTo"); // myChain when returned = domElement2

// To return the modified element within a chain, use the "return()" method.

var myElement = myChain.return();